Einführung der Vorlagen-Versionshistorie

Artikelbild
Autor Von DocuGenerate

27. Mai 2025

Was ist die Vorlagen-Versionshistorie?

Die Vorlagen-Versionshistorie ist eine leistungsstarke neue Funktion, die frühere Versionen Ihrer Vorlagen automatisch speichert, wenn Sie Änderungen vornehmen. So erhalten Sie einen vollständigen Verlauf der Entwicklung Ihrer Vorlagen über die Zeit und können bei Bedarf frühere Versionen wiederherstellen.

Bisher wurde bei jeder Aktualisierung einer Vorlagendatei in DocuGenerate die vorherige Version dauerhaft überschrieben. Viele unserer Nutzer umgingen diese Einschränkung, indem sie Versionen manuell verfolgten und Suffixe wie V1, V2 usw. oder andere Nummerierungsschemata zu ihren Vorlagennamen hinzufügten. Dieser Ansatz funktionierte, war jedoch umständlich und fehleranfällig.

Basierend auf Nutzerfeedback und Feature-Anfragen haben wir ein robustes Versionsverwaltungssystem entwickelt, das alle Änderungen an Ihren Vorlagen in DocuGenerate automatisch verfolgt und so die Notwendigkeit einer manuellen Versionsverfolgung entfällt.

Warum die Versionshistorie Wichtig ist

Die Versionsverwaltung von Vorlagen löst mehrere kritische Herausforderungen, mit denen Dokumentenerersteller täglich konfrontiert werden. Da Unternehmen zunehmend auf Vorlagen für Konsistenz und Effizienz in ihren Dokumenten-Workflows angewiesen sind, wird die Notwendigkeit einer zuverlässigen Versionskontrolle essenziell. Mit dieser Funktion können Sie die Integrität Ihrer Vorlagen wahren und gleichzeitig notwendige Änderungen und Verbesserungen im Laufe der Zeit vornehmen.

1. Schutz vor Versehentlichen Änderungen
Jeder macht Fehler. Ob versehentliches Hochladen der falschen Datei oder unbeabsichtigte Änderungen an einer Vorlage – die Versionshistorie bietet ein Sicherheitsnetz, mit dem Sie schnell eine frühere Version wiederherstellen können.

2. Verfolgung der Vorlagenentwicklung
Wenn sich Ihre Geschäftsprozesse weiterentwickeln, tun dies auch Ihre Vorlagen. Die Versionshistorie gibt Ihnen Einblick in die Entwicklung Ihrer Vorlagen über die Zeit und hilft Ihnen, die Evolution Ihres Dokumentengenerierungsprozesses zu verstehen.

3. Compliance- und Audit-Anforderungen
Für Unternehmen in regulierten Branchen kann ein Nachweis über Vorlagenänderungen für Compliance- und Auditszwecke entscheidend sein. Die Versionshistorie dokumentiert, was sich geändert hat und wann.

Wie die Vorlagen-Versionshistorie Funktioniert

Versionierung Aktivieren

Diese Funktion ist ausschließlich in unseren neuen Premium- und Business-Plänen verfügbar, wie auf unserer Preisseite beschrieben. Wenn Sie einen älteren Plan nutzen, können Sie diesen weiterhin unbegrenzt verwenden. Um jedoch von der Vorlagen-Versionshistorie zu profitieren, müssen Sie auf einen dieser neuen Pläne upgraden.

Für bestehende Vorlagen ist die Versionierung nicht standardmäßig aktiviert, kann jedoch über die Vorlageneinstellungen in der Web-App aktiviert werden:

Versionierung in den Vorlageneinstellungen aktivieren

Alternativ können Sie die Versionierung über unsere API aktivieren, indem Sie den Parameter versioning_enabled beim Aktualisieren einer Vorlage auf true setzen:

Parameter für den Vorlagen-Aktualisierungsendpunkt

Für neue Vorlagen ist die Versionierung standardmäßig aktiviert, wenn Ihr Konto Zugang zu dieser Funktion hat. Beim Erstellen einer Vorlage über die API können Sie den Parameter versioning_enabled explizit auf true oder false setzen.

Parameter für den Vorlagen-Erstellungsendpunkt

Wann Neue Versionen Erstellt Werden

Sobald die Versionierung für eine Vorlage aktiviert ist, wird automatisch eine neue Version gespeichert, wenn Sie die Vorlagendatei aktualisieren. Wichtig: Änderungen an Vorlagen-Metadaten (wie Name oder andere Einstellungen) erstellen keine neuen Versionen. Nur tatsächliche Änderungen an der Vorlagendatei selbst lösen die Erstellung einer neuen Version aus.

Dieser fokussierte Ansatz stellt sicher, dass Ihre Versionshistorie relevant bleibt und nicht mit kleineren Metadatenänderungen überladen wird, die keine Auswirkungen auf die Dokumentengenerierung haben. Indem wir nur wesentliche Änderungen am Vorlageninhalt verfolgen, helfen wir Ihnen, eine übersichtliche und aussagekräftige Versionshistorie zu pflegen, die die tatsächliche Entwicklung Ihres Vorlagendesigns und Ihrer Funktionalität hervorhebt und es einfacher macht zu erkennen, wann und wie wichtige Änderungen vorgenommen wurden.

Vorlagenversionen Verwalten

In der Vorlagendetailansicht finden Sie ein neues Versions-Panel, das alle gespeicherten Versionen Ihrer Vorlage anzeigt. Die aktuell aktive Version ist mit einem Stern-Symbol hervorgehoben:

Versionen-Panel in der Vorlagendetailansicht

Wenn Sie auf eine Version in der Liste klicken, wird eine Vorschau dieser Version im linken Bereich angezeigt, sodass Sie den Inhalt vor einer Aktion überprüfen können. Für jede Version sind folgende Aktionen möglich:

  • Restore: Diese Aktion ersetzt die aktuelle Vorlagendatei durch die ausgewählte Version und aktualisiert auch die Vorlageneinstellungen (Name, Begrenzer, Tags usw.) dieser Version. Nach der Wiederherstellung wird die ausgewählte Version zur aktuellen aktiven Version.

  • Download: Diese Aktion ermöglicht das Herunterladen einer bestimmten Version der Vorlagendatei auf Ihr lokales Gerät. Dies ist nützlich, wenn Sie eine frühere Version offline überprüfen oder bearbeiten möchten.

  • Delete: Wenn Sie eine bestimmte Version nicht mehr benötigen, können Sie sie ganz einfach aus Ihrer Historie entfernen. Beachten Sie, dass diese Aktion dauerhaft und nicht rückgängig zu machen ist – gehen Sie daher vorsichtig damit um.

Es gibt keine Begrenzung der Anzahl von Versionen, die für eine Vorlage gespeichert werden können, und bietet Ihnen so einen umfassenden historischen Überblick über die Entwicklung Ihrer Vorlage.

Überlegungen zur Multi-Region

Wenn Sie unsere Funktion zur Multi-Region-Verarbeitung und -Speicherung nutzen, ist es wichtig zu verstehen, wie die Versionierung mit Regionseinstellungen interagiert. Diese Interaktion beeinflusst, wo Ihre historischen Vorlagenversionen gespeichert werden und wie sie verwaltet werden, wenn Sie die Region einer Vorlage ändern, was Compliance-Anforderungen und Data-Governance-Richtlinien beeinflussen kann.

Vorlagenversionen werden immer in der aktuellen Region der Vorlage gespeichert. Wenn Sie die Region einer Vorlage ändern (z. B. von USA nach EU), wird nur die aktuelle Vorlagendatei in die neue Region verschoben. Frühere Versionen verbleiben in der ursprünglichen Region.

Neue Versionen, die nach dem Regionswechsel gespeichert werden, werden jedoch in der neuen Region gespeichert. Das bedeutet, dass die Versionshistorie Ihrer Vorlage mit der Zeit mehrere Regionen umspannen kann. Dieser Ansatz minimiert Datentransfers und stellt gleichzeitig sicher, dass sich Ihre aktuelle Vorlage immer in der von Ihnen angegebenen Region befindet.

Berechtigungen für Teammitglieder

Für Nutzer, die Vorlagen mit Teammitgliedern teilen, verbessert die Versionshistorie die Zusammenarbeit auf verschiedene Arten, abhängig von der Berechtigungsstufe:

  • Teammitglieder mit Write-Berechtigung können Vorlagen aktualisieren, frühere Versionen wiederherstellen und Versionen aus der Historie löschen. Sie haben umfassende Kontrolle über das Vorlagenmanagement, ähnlich dem Vorlageninhaber, mit der einzigen Ausnahme, dass sie die Vorlage selbst nicht löschen können.

  • Teammitglieder mit Read-Berechtigung können Vorlagenversionen nur anzeigen und herunterladen. Sie können keine Änderungen an der aktuellen Vorlage vornehmen oder frühere Versionen wiederherstellen. Bei der Ansicht einer Vorlage mit reiner Leseberechtigung sehen sie eine vereinfachte Version des Versionen-Panels:

    Versionen-Panel-Ansicht für Teammitglied mit Leseberechtigung

Dieser berechtigungsbasierte Ansatz stellt sicher, dass Teammitglieder je nach ihrer Rolle im Zusammenarbeitsprozess angemessenen Zugriff auf die Versionshistorie haben. Teamleiter können Bearbeitungsverantwortlichkeiten für Vorlagen selbstsicher delegieren und dabei die Übersicht behalten, und Teammitglieder mit reiner Leseberechtigung können weiterhin von der Entwicklungshistorie der Vorlage profitieren, ohne das Risiko unbeabsichtigter Änderungen.

API-Einschränkungen

Um unsere API einfach und fokussiert zu halten, ist das Verwalten von Vorlagenversionen nur über die Web-App möglich. Bei der Verwendung der API interagieren Sie immer mit der aktuellen Version einer Vorlage. Das bedeutet:

  • Sie können Vorlagenversionen über die API nicht auflisten, wiederherstellen oder löschen.
  • Die Dokumentengenerierung verwendet immer die neueste Version der Vorlage.
  • Sie können die Versionierung für eine Vorlage über die API aktivieren oder deaktivieren, aber die Versionen selbst nicht verwalten.

Diese Designentscheidung hält die API unkompliziert und bietet dennoch die Flexibilität, die Versionierung für über die API erstellte oder aktualisierte Vorlagen zu aktivieren.

Anwendungsszenarien

Lassen Sie uns einige reale Szenarien erkunden, in denen die Vorlagen-Versionshistorie erheblichen Mehrwert bieten kann:

Szenario 1: Wiederherstellung nach Versehentlichen Änderungen

Ein Mitglied des Marketing-Teams lädt versehentlich die falsche Datei hoch, wenn es eine kritische Kundenkommunikationsvorlage aktualisiert, und überschreibt die korrekte Version mit einem unvollständigen Entwurf.

Der Teamleiter entdeckt den Fehler, öffnet die Vorlage in DocuGenerate, navigiert zum Versionen-Panel, findet die letzte korrekte Version und klickt auf Restore. Innerhalb von Sekunden ist die Vorlage wieder in ihrem richtigen Zustand, ohne Unterbrechung des Geschäftsbetriebs.

Ohne Versionshistorie müsste das Team die Vorlage von Grund auf neu erstellen oder hoffen, dass jemand eine lokale Kopie der richtigen Version hat, was möglicherweise zu Verzögerungen in der Kundenkommunikation führen würde.

Szenario 2: Vorlagenentwicklung und Compliance

Ein Unternehmen aus dem Finanzdienstleistungsbereich muss Aufzeichnungen darüber führen, wie sich seine Kundenvertragsvorlagen im Laufe der Zeit verändert haben, um regulatorische Compliance-Anforderungen zu erfüllen.

Mit aktivierter Versionierung kann das Compliance-Team die vollständige Historie der Vorlagenänderungen einsehen, bestimmte Versionen für Auditszwecke herunterladen und Regulatoren eine klare Zeitlinie der Vorlagenentwicklung nachweisen.

Ohne Versionshistorie müsste das Unternehmen einen manuellen Prozess zur Verfolgung von Vorlagenänderungen einführen und möglicherweise Kopien von Vorlagen unter verschiedenen Dateinamen oder an verschiedenen Orten speichern, was den Auditprozess komplexer und fehleranfälliger machen würde.

Szenario 3: Kollaborative Vorlagenentwicklung

Ein Rechtsteam entwickelt gemeinsam eine neue Vertragsvorlage, wobei mehrere Teammitglieder über mehrere Wochen Beiträge und Verfeinerungen einbringen.

Während Teammitglieder Änderungen vornehmen, wird jede Aktualisierung automatisch als neue Version gespeichert. Wenn eine bestimmte Änderung Probleme einführt oder den Anforderungen nicht entspricht, ist es einfach, eine frühere Version wiederherzustellen. Das Team kann außerdem die Entwicklung der Vorlage im Laufe der Zeit nachverfolgen, um zu verstehen, wie sie sich entwickelt hat.

Ohne Versionshistorie müsste das Team Änderungen manuell koordinieren und möglicherweise mehrere Kopien der Vorlage mit verschiedenen Dateinamen pflegen, was zu Verwirrung darüber führen könnte, welche Version die neueste oder genaueste ist.

Best Practices für die Versionsverwaltung

Um das Beste aus dieser Funktion herauszuholen, beachten Sie folgende Best Practices:

  1. Versionierung für Kritische Vorlagen Aktivieren
    Obwohl Sie möglicherweise nicht für jede Vorlage eine Versionierung benötigen, ist sie besonders wertvoll für häufig verwendete Vorlagen, komplexe Logik oder kritische Geschäftsabläufe.

  2. Sinnvolle Vorlagen-Updates Durchführen
    Versuchen Sie beim Bearbeiten einer Vorlage, zusammenhängende Änderungen zu bündeln, anstatt viele kleine inkrementelle Updates vorzunehmen. Dies hält Ihre Versionshistorie übersichtlich und aussagekräftig.

  3. Versionshistorie Regelmäßig Überprüfen
    Nehmen Sie sich gelegentlich Zeit, Ihre Vorlagen-Versionshistorie zu überprüfen und unnötige Versionen zu bereinigen. Obwohl es derzeit keine Begrenzung der Versionenanzahl gibt, macht eine fokussierte Historie die Navigation einfacher.

  4. Wesentliche Änderungen Dokumentieren
    Obwohl DocuGenerate automatisch verfolgt, wann Änderungen vorgenommen wurden, erfasst es nicht den Zweck oder die Absicht hinter diesen Änderungen. Erwägen Sie, ein separates Änderungsprotokoll für wichtige Vorlagen-Updates zu führen.

  5. Team-Berechtigungen Durchdacht Vergeben
    Wenn Sie Vorlagen mit Teammitgliedern teilen, überlegen Sie sorgfältig, welche Mitglieder „Schreib”-Zugriff benötigen. Für Nutzer, die nur Dokumente generieren müssen, ist der „Lese”-Zugriff ausreichend.

Fazit

Die Vorlagen-Versionshistorie stellt eine bedeutende Verbesserung der Vorlagenverwaltungsfähigkeiten von DocuGenerate dar. Durch automatisches Verfolgen von Änderungen und Bereitstellen von Werkzeugen zur Wiederherstellung früherer Versionen bietet diese Funktion Sicherheit, fördert die Zusammenarbeit und trägt zur Wahrung der Integrität Ihres Dokumentengenerierungsprozesses bei.

Wir freuen uns darauf zu sehen, wie diese Funktion Ihre Dokumentengenerierungs-Workflows verbessert und Ihrem Team hilft, effizienter und souveräner mit Vorlagen zu arbeiten. Wie immer freuen wir uns über Ihr Feedback und Ihre Vorschläge, während wir die Fähigkeiten von DocuGenerate weiter verbessern und ausbauen.

Ressourcen

Diesen Beitrag teilen